home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / falc_uti / 525_v211 / readme < prev   
Text File  |  1995-11-25  |  12KB  |  334 lines
  1.  
  2. FIVE TO FIVE Version 2.11
  3. -------------------------
  4. for ATARI ST/TT/Falcon
  5.  
  6. by Harald Schönfeld and Bernd Spellenberg
  7.  
  8. July 1995
  9.  
  10.  
  11. 'Five to Five' is a program to convert various sound file types, as used on
  12. different computer systems. Some packing algorithms and the following file
  13. types are currently supported by 525:
  14.  
  15. - DVSM (ATARI Falcon 'WinRec')
  16. - AVR (ATARI)
  17. - HSN (ATARI 'CrazySounds')
  18. - FORTUNE (ATARI Falcon 'Fortune')
  19. - SND, AU (Sun, Mac, NeXT)
  20. - WAV (PC)
  21. - AIFF (Mac, ATARI (Cubase))
  22. - Raw data
  23.  
  24. Additionally it is now possible to convert the sample frequency of the sound
  25. data and to use an adjustable low pas filter.
  26.  
  27.  
  28.  
  29. Copyright
  30.  
  31. Copyright 1994-95 by Harald Schönfeld and Bernd Spellenberg.
  32.  
  33. The program 525 is shareware. 525 may and shall be copied and spread under
  34. the condition that all program- and text- files of this archive are
  35. included. Commercial use (distribution, selling the program for money,
  36. spreading via PD disk series or CDs) is not allowed. But the authors may
  37. grant the permission for such use.
  38.  
  39.  
  40. Registration
  41.  
  42. If you use 525 regularely you have to pay the shareware fee of DM 20 ($ 15,
  43. £ 10). Payment can be done via EuroCheque (or other international money
  44. orders if you pay the fee!) or remittance order.
  45.  
  46. Banking account (for remittance orders only):
  47.     Harald Schönfeld
  48.     Kto. 5117726, Vereinigte Sparkasse im Landkreis Fürth, BLZ 76250110
  49. or
  50.     Bernd Spellenberg
  51.     Kto. 122343, Raiffeisenbank Fürth eG, BLZ 76260451
  52.  
  53. Please write your name in the comment field of the remittance order and send
  54. us your name, address, email address and a remark to 525 V2.02 for ATARI
  55. seperately (via mail or email). You will then recieve a personal key from
  56. us that allows you to register yourself in all future versions of the
  57. program for all supported platforms.
  58.  
  59.  
  60. Contact address
  61.  
  62. Send suggestions, criticism, comments, bug reports, cheques and
  63. registrations to:
  64.  
  65. Harald Schönfeld
  66.     Email: Harald.Schoenfeld@rzmail.uni-erlangen.de
  67.     Post: Lerchenstraße 2, 90587 Veitsbronn, Germany
  68.  
  69. Bernd Spellenberg
  70.     Email: Bernd.Spellenberg@rzmail.uni-erlangen.de
  71.     Post: Fürther Straße 11, 90617 Puschendorf, Germany
  72.  
  73.  
  74. Beta testers
  75.  
  76. Thanks to  Peter Sergedahl, Thomas 'Gryf' Binder, Wolfgang Simon und Adam
  77. 'Riker' Kulinski (ATARI) and 'Soundy' (OS2).
  78.  
  79.  
  80. Exemption from liability
  81.  
  82. The programmers can not be held responsible for any errors which may occur
  83. while using this software. We do not claim this software is useful for all
  84. applications.
  85.  
  86.  
  87.  
  88. 1. System requirements
  89.  
  90. Five to Five runs on all ATARI computers of the 680x0 series, no matter if
  91. MultiTOS or Magic is installed or not, and on Macintosh computers running
  92. MagicMac. 525 needs about 250 KB free RAM.
  93.  
  94.  
  95.  
  96. 2. Installation
  97.  
  98. Copy the program (525G.PRG=german, 525E.PRG=english) onto your
  99. harddisk.
  100.  
  101. If you own a resource editor, you can insert one of the included 525 icons
  102. into the deskicon.rsc file. In the next step, you can install that icon as
  103. the Five to Five desktop icon.
  104.  
  105.  
  106.  
  107. 3. Usage
  108.  
  109. After starting the program, the 'Convert Sample' dialog is shown and the
  110. 525 menu appears. There are the following menu items:
  111.  
  112.  
  113. Desk/about Five to Five...
  114.  
  115. Informs about the current version number and the regsistered user. To
  116. register as a user, press the 'Register' button and follow the instructions.
  117. After successfull registration the annoying copyright messages will no
  118. longer appear.
  119.  
  120.  
  121. File/Convert...
  122.  
  123. Here you can select samples for conversion and choose a new file type and
  124. format.
  125.  
  126. "File name" is a PopUp to select the import file. Just click onto the PopUp
  127. and select the file in the subsequent file select box. The file will be
  128. opened and 525 tries to get all necessary information from the file header.
  129. A brief information about the file will be shown on the right of the PopUp.
  130.  
  131. If 525 couldn't find a file header, a dialog box appears, where the format
  132. of the sample data has to be defined manually:
  133. - the frequency: Click onto the PopUp to select a predefined frequeny, or
  134.   type in any other frequency.
  135. - the pack/data format
  136. - the number format: Signed or unsigned
  137.  
  138. Many old ST samples are 8 Bit Mono unsigned.
  139.  
  140. To start the program, you can also drag a sound file icon onto the 525
  141. program icon. The file will then be used as import file. Using MultiTOS it
  142. is also possible, to drag a sound file icon from the desktop onto the 525
  143. main dialog window to import the file.
  144.  
  145. "Analyse" will show a detailed information about the import file. If the
  146. file was not yet analysed, the whole file will be scanned now. Then the
  147. information about length, type, format and peak level will be shown. The
  148. reported length is the length of the sample data (without any header).
  149.  
  150. To select the export file type, click onto the "File Type" PopUp menu. 525
  151. currently supports 7 different file types:
  152. - DVSM: For WinRec, Win Cut, Fortune (ATARI)
  153. - CIT : For Fortune (ATARI)
  154. - AVR : Many ATARI St/Falcon programs
  155. - HSN : CrazySounds (ATARI)
  156. - SND : Sun, NeXT, Mac
  157. - WAV : PC
  158. - AIFF: Mac, ATARI - also uncompressed AIFC
  159. - AIFF-Cubase: 512 byte aligned, but according to AIFF specifications
  160. - Raw data: Raw data for many different programs
  161.  
  162. To select the format of the export file, click onto the "Format" PopUp. For
  163. every file type the possible file formats will appear in the menu. An actual
  164. format consists of several basic formats:
  165.  
  166. - Stereo / Mono: Two or one channels
  167. - Signed / Unsigned: With or without sign
  168. - Motorola / Intel: For Motorola or Intel CPUs
  169. - 16 / 8 Bit / Mu-Law / Deltapack: 16 or 8 Bit are uncompressed,
  170.   Mu-Law and Deltapack are compressed. Deltapack needs as much memory as
  171.   Mu-Law, but sounds much better. 
  172.  
  173. If you select a format, an abbreviation of the complete format text will
  174. appear in the PopUp.
  175. Selecting 'Keep' in the PopUp menu ensures that the input format is used as
  176. export format if this is possible (which depends on the different file
  177. types). If it is not possible 525 chooses a format that does not use more
  178. memory than the import format.
  179.  
  180. Please notice that it is almost useless to convert a worse format to a
  181. better one. It only requires more memory but sounds the same. But it is
  182. possible that other programms support only some formats.
  183. Converting Mu-Law to deltapack can result in a slightly worse sound quality,
  184. although deltapack is the better format.
  185.  
  186. If the peak level of the import sample is rather low, it is useful to use
  187. "Maximize volume". Using this option, the file will be written with maximal
  188. possible volume (and a peek level of about 99% to 100%). In this case the
  189. file will be scanned once completely. If the following option is active,
  190. too, the file will be even scanned twice.
  191.  
  192. "Fade In/Out" allows you to fade in and out the volume of the sample at the
  193. beginning and end. This is very useful, as there are often some distortions
  194. at this part of the sample. The duration of this effect can be typed in both
  195. for the start and the end of the sample if the option is selected. You can
  196. type in 1 to 9999 milli seconds. If 0 is used, the option has no effect.
  197.  
  198. By selecting the button "Convert Frequency" it is possible to convert the
  199. sample data from the given sample frequency to any other frequency. You can
  200. select this frequency by choosing any from a PopUp with pre defined standard
  201. values or by typing it in.
  202. Converting a sample to a higher frequency increases the length of the file
  203. while the sound quality surely will not get better. Converting to a lower
  204. frequency leads to a shorter file, while the higher frequencies in the
  205. sample data are lost.
  206.  
  207. If frequency conversion is selected, the low pass filter is automatically
  208. activated. This is necessary to avoid harmonic distorsions when converting
  209. to a higer sample rate and to avoid aliasing when converting to a lower
  210. sample rate. The correct edge frequency is automatically selected.
  211. Unfortunately the filtering process takes some additional time. So if you
  212. want to hear the result faster and if you don't care about some distorsions,
  213. you can disable the filter manually.
  214.  
  215. "Low pass filter" can also be selected independently of the frequency
  216. conversion, for example to filter out noise. Just type in the edge frequency
  217. you want. Mark: The highst possible frequency in a sample with the sample
  218. rate f (e.g. 8000Hz) is f/2 (4000Hz). So the highst possible edge frequency
  219. is the half of the sample rate.
  220.  
  221. To write the new file select the "Export" button. At first a file select box
  222. appears to select the export file name. If a file with the same name already
  223. exists, a warning message appears and you can stop the export. During export
  224. a visual progress indicator tells you about the current status of the export
  225. operation. If the export file name is the same as the import file name, a
  226. temporal file will be created. To abort the convert process, press ESC or
  227. UNDO.
  228.  
  229.  
  230. File/Quit
  231.  
  232. Quits the program.
  233.  
  234.  
  235.  
  236. 4. Internals
  237.  
  238. One supported sample type is the DVSM-Format of the programs WinRec, WinCut
  239. and Fortune. Those are programs for the ATARI FALCON.
  240.  
  241. A DVSM sample file has the following structure:
  242.  
  243. typedef struct
  244. {
  245.     char magic[6];     /* "DVSM" */
  246.     int headlen;       /* Headlen in Bytes*/
  247.     int freq;           /* Sample freqency 0=8kHz 7=50kHz*/
  248.     char pack;           /* 0 unpacked, 2=DVS pack method*/
  249.     char mode;         /* 0=Stereo 8Bit,1=Stereo 16Bit,2=Mono 8Bit,3=Mono 16*/
  250.     long blocklen;     /* if pack>0: Length of a packed block*/ 
  251. } DVSMHEAD;
  252.  
  253. followed by cookies and the sound data.
  254.  
  255. The sample frequencies 0 to 7 correspond to the following frequencies:
  256. sam_freq[8]={8195,9834,12292,16390,19668,24585,32778,49170};
  257.  
  258. For further information refer to the WinRec documentation or take a look at
  259. the article series 'Sound Sample Formate' in the german magazin ST Computer
  260. (3/94 - 6/94).
  261.  
  262.  
  263.  
  264. 5. Known Bugs
  265.  
  266. None.
  267.  
  268.  
  269.  
  270. 6. Release History
  271.  
  272. 04/12/93: Version 0.9
  273.  
  274. 04/12/94: Version 0.91
  275.           - Correction in DVSM import
  276.  
  277. 05/05/94: Version 1.0
  278.           - AES 4.02 3D support
  279.           - Copyright Maxon
  280.  
  281. 11/27/94: Version 2.0
  282.           - Complete re write of the program.
  283.           - New file types: CIT (Fortune)
  284.                             HSN (CrazySounds)
  285.           - Fade in/out time seperately adjustable
  286.           - Correct volume maximation in connection with fading
  287.           - Visual progress indicator
  288.           - Drag&Drop
  289.  
  290. 02/01/95: Version 2.01
  291.           - New file type: AIFF (Mac, ATARI)
  292.                            AIFF-Cubase (Cubase)
  293.           - Iconize bug with MultiTOS in monochrome mode fixed
  294.           - Bug in user defined message handling corrected
  295.  
  296. 03/05/95: Version 2.01 for OS/2
  297.  
  298. 03/12/95: Version 2.02 for ATARI
  299.           - Shareware registration dialog
  300.           - Icon for desktop resource file included
  301.  
  302. 04/17/95: Version 2.1 for ATARI
  303.           - Frequency conversion
  304.           - Adjustable low pass filter
  305.           - User break during conversion by pressing ESC or UNDO
  306.           - The program can now be hidden using MagiC
  307.           - Bug in command line parameter handling corrected
  308.           - Correct file delete of the export file during 'disk full' on MTOS/MagiC
  309.  
  310. 07/18/95: Version 2.11 for ATARI
  311.           - Check back if export file already exists
  312.           - Bugfix in dialog memory management
  313.           - Problem with export status bar fixed
  314.           - Bug in registration dialog fixed
  315.           - Bug in DVS-Import/Export with frequency conversion fixed
  316.  
  317. 07/18/95: Version 2.11 for OS/2
  318.           - Functionally equivalent to the ATARI version 2.11
  319.           - First German release
  320.  
  321.  
  322.  
  323. 7. Future Plans
  324.  
  325. - More formats
  326.     .AIFC compressed
  327.     .WAVE 4Bit
  328.     .ADPCM
  329.     .Yamaha
  330.  
  331. - Additional platforms
  332.     .Macintosh
  333.     .DEC Alpha (OSF/1-Digital Unix)
  334.